home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / obsali.zip / ALIAS.DOC next >
Text File  |  1991-09-23  |  33KB  |  945 lines
  1.    
  2.    
  3.    
  4.    
  5.    
  6.    
  7.                                Obs Toolkit (TM)
  8.    
  9.                                 Alias component
  10.    
  11.                                   User Manual
  12.    
  13.    
  14.    
  15.    
  16.    
  17.                                  A DOS toolkit
  18.    
  19.                        providing ultimate capability to
  20.    
  21.                          Command Line and Batch users
  22.    
  23.    
  24.    
  25.    
  26.    
  27.    
  28.                               _______
  29.                          ____|__     |                (R)
  30.                       --|       |    |-------------------
  31.                         |   ____|__  |  Association of
  32.                         |  |       |_|  Shareware
  33.                         |__|   o   |    Professionals
  34.                       -----|   |   |---------------------
  35.                            |___|___|    MEMBER
  36.    
  37.    
  38.    
  39.    
  40.    
  41.    
  42.                                 Contrails, Inc.
  43.                                  P.O. Box 2759
  44.                              Lompoc, CA 93438-2759
  45.    
  46.                                 CIS 71121,2426
  47.    
  48.    
  49.    
  50.                               Program created by
  51.                                Keith E. Robbins
  52.    
  53.    
  54.    
  55.                               Copyright (c) 1991
  56.                               by Contrails, Inc.
  57.                               All rights reserved
  58.    
  59.    
  60.        
  61.    
  62.                                 Alias (ALIAS)
  63.                                 -------------
  64.    
  65.      Description:
  66.         ALIAS is a tool to allow synonyms to be created and executed as a
  67.         part of DOS. It is a clean and easy way to build custom commands
  68.         without having to resort to disk eating batch files.
  69.    
  70.         Commands can be as simple as
  71.    
  72.            1) Renaming a program to something you are more comfortable with
  73.    
  74.            2) Invoking a program that isn't in your path
  75.    
  76.            3) Invoking a program with certain options
  77.    
  78.            4) Bypassing internal commands to something a tad bit more usable
  79.    
  80.         Notes:
  81.            ObsRes must be installed in order for ALIAS to operate.
  82.    
  83.            Aliases do not function in batch files. We haven't built that
  84.            tool yet, so in your batch files you'll have to type out each
  85.            command with the correct options selected.
  86.    
  87.            Aliases do not work in all DOS shells. To minimize this
  88.            inconvenience ReRes reinstates aliases in shells that have
  89.            disabled them.
  90.    
  91.            Aliases all come with spaces. If you do not want a space at the
  92.            end of your alias, then you must prefix the definition with the
  93.            /NOSPACE qualifier.
  94.    
  95.    
  96.         Alias provides five (5) functions:
  97.    
  98.            1) Placing aliases into the dictionary (e.g., ALIAS name command)
  99.    
  100.            2) Outputting the dictionary in a form suitable for /FILE
  101.               processing or batch files (e.g., ALIAS > name.bat)
  102.    
  103.               Note: Redirection will not store the comments which may be in
  104.                     your alias definition file.
  105.    
  106.            3) Setting translation options (e.g., ALIAS /ON)
  107.    
  108.            4) Getting status on current translation options (ALIAS /STATUS)
  109.    
  110.            5) Editing existing aliases (ALIAS /EDIT name)
  111.    
  112.      TIPS:
  113.         Use Alias to build custom commands.
  114.    
  115.    
  116.    
  117.    
  118.    
  119.                                       -1-    
  120.    
  121.         Once an alias is defined, you can bypass it by preceding the command
  122.         with a space. Assuming that DIR has been aliased (e.g., ALIAS dir
  123.         LF).
  124.    
  125.            C>DIR   - this would invoke the aliased DIR (lf)
  126.            C> DIR  - this would invoke DOS's DIR
  127.    
  128.      Usage:
  129.         ALIAS
  130.            This displays all currently defined aliases.
  131.    
  132.         ALIAS name
  133.            This displays the translation (if any) for NAME.
  134.    
  135.         ALIAS [/NOSPACE] name command
  136.            This defines an alias where NAME translates to COMMAND.
  137.    
  138.         ALIAS /NULL name
  139.            This defines a null alias.
  140.    
  141.         ALIAS [options]
  142.            The options are defined and described below.
  143.    
  144.      Options:
  145.         /[NO]CAse - observe case of alias names
  146.            This option instructs the translator to view aliases as case
  147.            sensitive. This means that cd != CD (is not equal to). The case
  148.            of commands is always retained regardless of this option.
  149.    
  150.            Use /NOCASE to disable case sensitivity.
  151.    
  152.         /CLear - delete all aliases
  153.            This command deletes all aliases. When ObsRes is first installed,
  154.            the alias dictionary is clear.
  155.    
  156.         /Delete - delete an alias
  157.            Usage: ALIAS /DELETE name
  158.    
  159.            This removes an alias definition. If the alias does not exist
  160.            then no error is reported.
  161.    
  162.            TIP:
  163.                Create an unalias command to remove aliases.
  164.                   C>ALIAS unalias ALIAS /DELETE
  165.    
  166.         /[NO]ECho - echo translations to the console
  167.            This option instructs the translator to echo the translation
  168.            command to the console whenever a substitution is made. The
  169.            translation is output to the display just below the command
  170.            line.
  171.    
  172.            This command is directly available as a ".COMMAND" from the
  173.            command line (.ECHO).
  174.    
  175.    
  176.    
  177.    
  178.                                       -2-    
  179.    
  180.            TIP:
  181.                This can be useful to learn commands and their options.
  182.    
  183.                Echo can let you know when translations are occurring.
  184.    
  185.            Use /NOECHO to disable echo translations.
  186.    
  187.         /EDit - edit the specified alias definition
  188.            Usage: ALIAS /EDIT name
  189.    
  190.            This command will bring up a line editor to allow you to edit
  191.            the current alias name/command pair. Using the line editor is
  192.            simple and intuitive. Refer to "Getting Started / Line Editor"
  193.            for a description of the line editor commands.
  194.    
  195.            TIP:
  196.                When you want to make a change to an existing alias, don't
  197.                redefine it; /EDIT it.
  198.    
  199.            Note:
  200.                When you change the name of the alias, the old alias is
  201.                neither deleted nor modified in any way. You can use the
  202.                editor as a quick and dirty way to make a copy of an existing
  203.                alias.
  204.    
  205.         /File - process alias commands from a file
  206.            Usage: ALIAS [/CLEAR] /FILE filename.ext
  207.    
  208.            This option directs the alias generator to read the specified
  209.            file and process the commands as if they were issued at the
  210.            command line.
  211.    
  212.            DOS commands ECHO and REM are processed the same as DOS would.
  213.    
  214.               ECHO controls whether commands are echoed to the console or
  215.               not and can be used to display messages to the console.
  216.    
  217.               REM can be used to place comments into the alias definition
  218.               file.
  219.    
  220.            The DOS 3.3+ '@' command qualifier is processed also. It inhibits
  221.            echo of the current line regardless of the ECHO state.
  222.    
  223.            Alias definition files can be nested. The nesting limit is
  224.            limited only by the maximum number of open files.
  225.    
  226.            Note:
  227.               Unlike DOS batch processing, the initial ECHO mode for alias
  228.               definition files when processed by the alias generator is ECHO
  229.               OFF.
  230.    
  231.    
  232.    
  233.    
  234.    
  235.    
  236.    
  237.                                       -3-    
  238.    
  239.               If a line in the alias definition file is not understood by
  240.               the alias generator, then an error message for that line will
  241.               be posted. The line will be ignored and processing will
  242.               continue with the next line.
  243.    
  244.               /CLEAR can be used to clear out the existing aliases before
  245.               loading in the new set.
  246.    
  247.         /Make - define a path alias
  248.            Usage: ALIAS /MAKE name
  249.    
  250.            This option defines a path alias. The alias is defined to be
  251.    
  252.              ALIAS /NOSPACE name <current directory>\
  253.    
  254.            The command is provided so that the TRYIT.BAT program can provide
  255.            direct access to the commands without knowing, in advance, which
  256.            directory the Toolkit was placed into.
  257.    
  258.         /NOSpace - do not add a space after the name when translating
  259.            Usage: ALIAS /NOSPACE name cmd
  260.    
  261.            This option is valid during an alias definition only. Use of this
  262.            option directs the translator not to place a space after the
  263.            translation. This allows catenation of an alias with its
  264.            supporting text.
  265.    
  266.            Example:
  267.              C>ALIAS /NOSPACE chmod MF /SA
  268.    
  269.              C>chmod +r file.exe
  270.    
  271.              When CHMOD is issued at the command line the first command line
  272.              argument will be directly appended to the translation. This
  273.              yields (using the example above)
  274.    
  275.                C>MF /SA+r file.exe
  276.    
  277.         /NUll - define a null alias
  278.            Usage: ALIAS /NULL name
  279.    
  280.            This option allows you to define a NULL alias. One that
  281.            translates to nothing. This option allows you to place a prefix
  282.            before a command name and to disable it when necessary. This
  283.            option needs recursion to be active in order to be effective.
  284.    
  285.            Example:
  286.               C>ALIAS /RECURSE
  287.               C>ALIAS /NULL    ob
  288.               C>ALIAS          ocd   ob ocd.exe
  289.               C>ALIAS          cd    ocd
  290.    
  291.    
  292.    
  293.    
  294.    
  295.    
  296.                                       -4-    
  297.    
  298.               When CD is typed at the command line, the command will be
  299.               equivalent to C>OCD.EXE. If OB were to be defined as
  300.    
  301.                 C>ALIAS /NOSPACE ob c:\util\
  302.    
  303.               then, when CD is typed at the command line, the command will
  304.               be equivalent to C>C:\UTIL\OCD.EXE
  305.    
  306.         /ON  - enable translator     (default)
  307.            This option returns the translator to its active state. If the
  308.            translator was already active, then no change will occur.
  309.    
  310.            This command is also directly available as a ".COMMAND" from the
  311.            command line (.ON).
  312.    
  313.         /OFf - disable translator
  314.            This option causes the translator to become passive. This may be
  315.            handy if some program needs the aliased commands and it is not
  316.            convenient to precede them by a space.
  317.    
  318.            This command is also directly available as a ".COMMAND" from the
  319.            command line (.OFF).
  320.    
  321.            TIP:
  322.                If ALIAS translations affect one of your programs adversely
  323.                (keeps swapping your text), then use a batch file to turn the
  324.                aliases off, execute your program and then turn the aliases
  325.                on again.
  326.    
  327.         /Page - Page the output
  328.            This instructs ALIAS to pause when outputting aliases and the
  329.            screen is full.
  330.    
  331.         /[NO]Recurse - Recursively apply aliases
  332.            This allows aliases to be defined in terms of other aliases.
  333.            After an aliased command is translated, the translator will
  334.            attempt to translate the new command.
  335.    
  336.            Use /NORECURSE to disable recursive alias translations.
  337.    
  338.            Note:
  339.               The recursion process is limited to ten levels. If more than
  340.               ten levels are detected, the translator will report an error
  341.               and the command line will be ignored. This is to prevent an
  342.               endless loop (when a command aliases back to itself).
  343.    
  344.            TIP:
  345.               Use recursive aliases to reduce program access time.
  346.    
  347.               Example:
  348.                  C>ALIAS /RECURSE
  349.                  C>ALIAS          dir     LF
  350.                  C>ALIAS          bytime  LF /OD
  351.                  C>ALIAS          lf      ob lf.exe
  352.                  C>ALIAS /NOSPACE ob      c:\util\
  353.    
  354.    
  355.                                       -5-    
  356.    
  357.                  When the DIR, or BYTIME command is issued, the translator
  358.                  will use "c:\util\lf.exe ". This way, LF can be accessed
  359.                  immediately without DOS having to search the PATH.
  360.    
  361.                  You can verify this performance advantage by using
  362.                     C>LOCATE dir
  363.    
  364.                  You can see the translation passed to the command line by
  365.                  enabling the /ECHO feature.
  366.    
  367.                  The performance advantage may not be so noticeable if you
  368.                  are using good disk caching software or a very fast disk.
  369.    
  370.         /Status - Get current status of the alias translator
  371.            Display the mode that the alias translator is working in. The
  372.            status information tells whether the translator is active or
  373.            passive (on or off); whether or not the translator is case
  374.            sensitive; whether or not translation echoes are being performed;
  375.            whether or not aliases are being applied recursively; the number
  376.            of aliases defined and the amount of free space available in the
  377.            translator's buffer.
  378.    
  379.      Examples:
  380.         C>ALIAS unalias ALIAS /DELETE
  381.           This defines UNALIAS to be equivalent to ALIAS /DELETE. Whenever
  382.           you want to delete an alias just type UNALIAS CMD.
  383.    
  384.         C>ALIAS > aliases.bat
  385.           This uses DOS redirection to create a batch file that saves the
  386.           current aliases and alias translator settings. The batch file can
  387.           be executed later to add these aliases back into the translation
  388.           table. If you chose to keep comments in your alias definition
  389.           file, then it is better to use an editor to add permanent aliases.
  390.           Redirection does not store comments.
  391.    
  392.           TIP:
  393.             Use DOS redirection to save your aliases in a batch file.
  394.               C>ALIAS > myalias.bat
  395.    
  396.               That file can be processed by DOS (as a batch file) or by
  397.               ALIAS using the /FILE option. Letting ALIAS process the file
  398.               is significantly quicker.
  399.    
  400.           TIP:
  401.             Place OBSRES in your autoexec.bat file and then call the alias
  402.             definition file (which you create) with ALIAS /FILE so that the
  403.             aliases that you want to keep are available each time you reboot
  404.             or power-up your machine.
  405.    
  406.         C>ALIAS /STATUS
  407.           This tells you what the current configuration the translator is
  408.           executing under. It reports translator conditions such as:
  409.    
  410.    
  411.    
  412.    
  413.    
  414.                                       -6-    
  415.    
  416.             o Case sensitivity (on / off)
  417.             o Translator (on / off)
  418.             o Recursion (on / off)
  419.             o Echo (on / off)
  420.             o Number of aliases defined
  421.             o Size and space available in alias dictionary
  422.    
  423.         C>ALIAS /NOSPACE ob c:\util\
  424.           This will define an alias named OB. The alias definition is
  425.           special in that when a translation occurs, it will not append a
  426.           space after the translated text.
  427.    
  428.         C>ALIAS lf ob lf.exe
  429.           Using the OB alias definition above and recursive aliases, the
  430.           translation for LF will be C:\UTIL\LF.EXE. This principle is
  431.           applied to all of OBS ToolKit commands that are supplied in the
  432.           recursive alias definition file.
  433.    
  434.         C>ALIAS /NULL ob
  435.           This would cause the translation of OB to be nothing. Using the LF
  436.           definition immediately above and recursive aliases, the
  437.           translation of LF will be LF.EXE. The use of the NULL qualifier
  438.           allows you to revert back to path searching when invoking aliased
  439.           commands.
  440.    
  441.         C>ALIAS unalias
  442.           This will show you the translation of UNALIAS if it exists. If
  443.           UNALIAS does not exist, then no operation will be performed.
  444.    
  445.      Notes:
  446.         If you are more comfortable with case sensitive aliases, then use
  447.         the /CASE switch.
  448.    
  449.         Note:
  450.           If you do switch from CASE to NOCASE then the NAME with the
  451.           nearest upper-case character will take precedence over the NAME
  452.           without. When you switch back from NOCASE to CASE, order will be
  453.           returned.
  454.    
  455.         => The above rule is true even when you redefine or delete an alias
  456.            name.
  457.    
  458.         The alias dictionary size defaults to 2K bytes but can be set via
  459.         ObsRes at its installation time.
  460.    
  461.         Default configuration for the translator is:
  462.            1) Case insensitive
  463.            2) Echo disabled
  464.            3) Translator active
  465.            4) Recursion disabled
  466.    
  467.    
  468.    
  469.    
  470.    
  471.    
  472.    
  473.                                       -7-    
  474.    
  475.                                     ObsRes
  476.                                     ------
  477.      Description:
  478.         ObsRes is a well behaved memory resident utility (TSR) that provides
  479.         a central focal point to Obs Toolkit. All of Obs tools, except for
  480.         Alias, will function without ObsRes, but some functionality will be
  481.         lost.
  482.    
  483.         ObsRes serves four (4) key functions:
  484.    
  485.            1) Performs the Alias translations from NAME to COMMAND
  486.    
  487.            2) Maintains the Alias dictionary in resident RAM
  488.    
  489.            3) Maintains the DirStack (directory stack) in resident RAM
  490.    
  491.            4) Offers DOT commands to control translator operations.
  492.    
  493.         ====> ObsRes must be installed after any command line editors.
  494.               Command line editors play around with the input, and ObsRes
  495.               will never see it.
  496.    
  497.               If it is necessary to load ObsRes before such a program, then
  498.               you can use ReRes to get control back.
  499.    
  500.         If you use a DOS command line editor (many are available), then the
  501.         recall buffer will contain the command that you typed. If you don't
  502.         use a command line editor (why would you not?) then the command
  503.         recall (F3) will contain the translated command.
  504.    
  505.         If you are using NDOS or 4DOS and you want to use Obs Aliases, then
  506.         issue the SETDOS command with the /L1 option. This will inform NDOS
  507.         and 4DOS to get keyboard input the same way that COMMAND.COM does.
  508.    
  509.         Each alias defined takes the number of characters defined plus five
  510.         (5) bytes of overhead (four (4) on /NOSPACE definitions).
  511.    
  512.         Each DirStack entry takes up 67 bytes.
  513.    
  514.         The sum space requested is combined with ObsRes resident code to
  515.         produce the resident space requirement. The actual amount of memory
  516.         reserved for a TSR is variable depending upon the current
  517.         environment block and the TSRs Drive:\Path\FileName.exe.
  518.    
  519.      Usage:
  520.        OBSRES [Dictionary size [DirStack Depth]]
  521.    
  522.      Options:
  523.        Dictionary Size
  524.           Specifies the number of bytes to retain for alias definitions.
  525.           This directly affects the size of the resident image. For each 16
  526.           bytes, 1 paragraph (16 bytes) is reserved.
  527.    
  528.    
  529.    
  530.    
  531.    
  532.                                       -8-    
  533.    
  534.           Minimum size - 128 bytes
  535.              Hardly enough for anything serious.
  536.    
  537.           Maximum size - 4096 bytes
  538.              More than enough for even the most serious. If this is not
  539.              enough, then we apologize. The limit is there to inhibit the
  540.              unaware from eating up too much memory. Send us a request,
  541.              we'll grow to meet your needs.
  542.    
  543.           Default size - 2048 bytes
  544.              A modest amount that will meet the needs of most users.
  545.    
  546.           TIP:
  547.              Use ALIAS /STATUS to determine the slack space in the Alias
  548.              dictionary.
  549.    
  550.    
  551.        DirStack Depth
  552.           Specifies the number of locations to be maintained on the
  553.           directory stack.
  554.    
  555.           Minimum depth - 1 entry
  556.              This allows you to return from whence you came and provides
  557.              one (1) SmartPath.
  558.    
  559.           Maximum depth - 9 entries.
  560.              This is a lot for even the most keen. This is a hard and fast
  561.              limit. You can only use one letter to identify a disk, and all
  562.              the characters are reserved by DOS.
  563.    
  564.           Default depth - 4 entries.
  565.              This provides for ample POPs, and four (4) SmartPaths.
  566.    
  567.    
  568.      Internal Commands:
  569.        ObsRes has four (4) internal DOT commands to configure its'
  570.        operation. The internal commands are there to permit you to enable
  571.        and disable certain features of the Toolkit during the customization
  572.        process.
  573.    
  574.        .ECHO   -- Enable the translation echo
  575.        .NOECHO -- Disable the translation echo
  576.        .OFF    -- Disable the translator
  577.        .ON     -- Enable the translator
  578.    
  579.        The .ON and .OFF are particularly handy when optimizing system
  580.        performance by setting the definition of the "OB" alias. If the
  581.        response "Bad command or file name" occurs, because the "OB" alias is
  582.        defined incorrectly, then typing ".OFF" will place COMMAND.COM back
  583.        into control.
  584.    
  585.    
  586.    
  587.    
  588.    
  589.    
  590.    
  591.                                       -9-    
  592.    
  593.        The .ECHO and .NOECHO can be used to see what the effect of the
  594.        translation is, so that the bad command can be isolated, and
  595.        corrected.
  596.    
  597.        The ".COMMAND" operations are further described in ALIAS under their
  598.        appropriate "/COMMAND". The ".COMMANDs" are not available in batch
  599.        files.
  600.    
  601.      Examples:
  602.         OBSRES
  603.            This will install ObsRes into memory with a default dictionary
  604.            size of 2K and a default DirStack depth of 4 entries. The memory
  605.            burden on your system will be roughly 4000 bytes.
  606.    
  607.         OBSRES 1024 9
  608.            This will install ObsRes into memory with a dictionary size of 1K
  609.            and a DirStack of 9 entries. The memory burden on your system
  610.            will be roughly 3400 bytes.
  611.    
  612.      TIP:
  613.         You can load ObsRes into High memory using an intelligent memory
  614.         manager such as the ones provided by DOS 5, Quarterdeck or Qualitas.
  615.         This will allow you to maximize your conventional memory.
  616.    
  617.         If don't want obs aliases then use the stand-alone DirStack.
  618.    
  619.    
  620.    
  621.    
  622.    
  623.    
  624.    
  625.    
  626.    
  627.    
  628.    
  629.    
  630.    
  631.    
  632.    
  633.    
  634.    
  635.    
  636.    
  637.    
  638.    
  639.    
  640.    
  641.    
  642.    
  643.    
  644.    
  645.    
  646.    
  647.    
  648.    
  649.    
  650.                                       -10-    
  651.    
  652.                                      ReRes
  653.                                      -----
  654.      Description:
  655.         ReRes is also a memory resident utility. We discovered the need for
  656.         it when we would shell into DOS from Windows/real mode and DESQview,
  657.         only to discover that we had lost our aliases. The DirStack was
  658.         still available, and we could list aliases, but the commands just
  659.         weren't getting swapped. We lost our powers, what a horror.
  660.    
  661.         The answer was to gen up a tiny utility (128 resident bytes) to get
  662.         back into the driver's seat. This is about as small as a TSR can get
  663.         without getting heavy into playing musical bytes.
  664.    
  665.         ReRes serves one (1) function:
  666.    
  667.            1) To regain aliases after you shell into a program that disables
  668.               them.
  669.    
  670.         ====> ReRes can be installed to regain alias control after a program
  671.               has hidden ObsRes.
  672.    
  673.         ObsRes must have previously been installed. ReRes works with ObsRes
  674.         only.
  675.    
  676.         If ObsRes is still functional (not locked out) when ReRes is
  677.         installed, the effect will be to nest the application of aliases one
  678.         level for each ReRes installed.
  679.    
  680.      Note: DOSKEY, NDOS, and 4DOS users
  681.         ReRes cannot claim back the command line after these programs have
  682.         been installed.
  683.    
  684.    
  685.    
  686.    
  687.    
  688.    
  689.    
  690.    
  691.    
  692.    
  693.    
  694.    
  695.    
  696.    
  697.    
  698.    
  699.    
  700.    
  701.    
  702.    
  703.    
  704.    
  705.    
  706.    
  707.    
  708.    
  709.                                       -11-    
  710.    
  711.    Line Editor
  712.    -----------
  713.      A simple line editor is provided in the Alias and EnvEdit tools. This
  714.      editor allows you to perform the following actions:
  715.    
  716.         Up Arrow     Move one line up (multiple line display only)
  717.         Down Arrow   Move one line down (multiple line display only)
  718.         Left Arrow   Move one character to the left
  719.         Right Arrow  Move one character to the right
  720.         INSERT       Toggle Insert/Overstrike mode
  721.         HOME   (^A)  Move to the beginning of the edit field
  722.         END    (^E)  Move to the end of the edit field
  723.         DELETE (^D)  Delete the current character
  724.         BACKSPACE    Delete the previous character
  725.         RETURN       Store changes and exit
  726.         ESCAPE       Abort changes and exit
  727.    
  728.    
  729.    ErrorLevels
  730.    -----------
  731.      A simple, but flexible policy on DOS ErrorLevels has been consistently
  732.      applied to all tools. The higher the error level, the more critical the
  733.      error was to the normal operation of the tool. At the bottom, or
  734.      errorlevel 0, is "NO ERRORs", while at the top, errorlevel 6 is an
  735.      "INSTALL" error, where the tool was unable to execute.
  736.    
  737.      The ErrorLevels are as follows:
  738.    
  739.      0 - NO ERROR         - No error encountered
  740.      1 - NOT FOUND        - File or object was "NOT FOUND"
  741.      2 - ABORTED          - The user chose to "ABORT" the operation
  742.      3 - OPERATION FAILED - The requested "OPERATION FAILED"
  743.      4 - LIMIT EXCEEDED   - The operation exceeded the tools "LIMIT"
  744.      5 - USAGE ERROR      - The tool displayed a "USAGE" error
  745.      6 - INSTALL FAILED   - The tool was unable to "INSTALL"
  746.    
  747.    
  748.    
  749.    
  750.    
  751.    
  752.    
  753.    
  754.    
  755.    
  756.    
  757.    
  758.    
  759.    
  760.    
  761.    
  762.    
  763.    
  764.    
  765.    
  766.    
  767.    
  768.                                       -12-    
  769.    
  770.    Options
  771.    -------
  772.       o Options may be placed on the command line in any order.
  773.    
  774.       o Options are processed from left to right.
  775.    
  776.       o Options must be seperated by spaces.
  777.    
  778.       o Options may appear anywhere on the command line (after the tools
  779.         name). For consistency in the examples provided, all options were
  780.         placed before the user supplied arguments.
  781.    
  782.         Exception:
  783.    
  784.           o ALIAS will only accept /NOSPACE, /NULL, /MAKE and /EDIT options
  785.             during an alias definition, and those options must be present
  786.             before the name of the alias to be defined.
  787.    
  788.       o Throughout this document, options were defined in UPPER and lower
  789.         case. The UPPER case portion is the minimum string recognized by the
  790.         tools. The lower case is the remainder of the option name. The lower
  791.         case portion is always optional, but if present must match.
  792.    
  793.    
  794.    Reading the Usage
  795.    -----------------
  796.       Parameters specified between '[' & ']' are optional. Their presence is
  797.       not required (the specific operation is dictated by the particular
  798.       tool).
  799.    
  800.       Parameters specified between '{' & '}' are repeatable.
  801.    
  802.       Parameters separated by a '|' are one or the other.
  803.    
  804.       You do not type the above symbols!
  805.    
  806.    Press any key...
  807.    ----------------
  808.       To pause a scrolling display, you may specify /Page as an option or by
  809.       pressing the <ESC> key during the scroll.
  810.    
  811.       When the computer is waiting at the "Press any key to continue..."
  812.       prompt, you may enter the <ESC> key for a continuous scroll, or any
  813.       other key to view the next screenful.
  814.    
  815.    
  816.    
  817.    
  818.    
  819.    
  820.    
  821.    
  822.    
  823.    
  824.    
  825.    
  826.    
  827.                                       -13-    
  828.    
  829.                                  Registration
  830.                                  ------------
  831.    
  832.    To register this component of Obs Toolkit, fill out the order form and
  833.    mail with payment to the address specified. You have the option of
  834.    registering the entire Toolkit (highly recommended). You can select that
  835.    option on the registration form also.
  836.    
  837.    
  838.    Component Registration
  839.    ----------------------
  840.    Individual component registration is $8.00 per component.
  841.    
  842.    Upon receipt of your order for only a component of Obs Toolkit, a thank
  843.    you letter will be promptly mailed to you. If there are any serious bugs
  844.    reported in the software, you will be automatically updated at no extra
  845.    cost to you.
  846.    
  847.    
  848.    Toolkit Registration
  849.    --------------------
  850.    Obs Toolkit registration is $39.00
  851.    
  852.    Upon receipt of your order for the entire Toolkit, a registered version
  853.    of Obs Toolkit will be promptly mailed to you. You will then be entitled
  854.    to updates at a reduced cost. If there are any serious bugs reported in
  855.    the software, you will be automatically updated at no extra cost to you.
  856.    
  857.    Toolkit registration includes a registered version and a printed manual.
  858.    
  859.    
  860.    Technical Support
  861.    -----------------
  862.    Technical support is always available. If after one (1) hour of phone
  863.    support you are asking basic questions (answers readily available in the
  864.    documentation), then the "free" technical support will be exhausted and
  865.    will become an additional cost item.
  866.    
  867.    
  868.    Individual Use
  869.    --------------
  870.    Registration of a Toolkit component is $8.00.
  871.    Registration for the complete Toolkit is $39.00 plus shipping and handling.
  872.    California residents must pay sales tax.
  873.    
  874.    
  875.    Corporations / Institutions
  876.    ---------------------------
  877.    Site licenses are not available for Toolkit components.
  878.    
  879.    A license to use Obs Toolkit is required in corporations and
  880.    institutions. The license will allow duplication of the Toolkit at a
  881.    single site for the number of copies purchased. The cost of the license
  882.    is based on the number of machines on which the Toolkit will be running.
  883.    
  884.    The schedule of fees is as follows:
  885.    
  886.                                       -14-    
  887.    
  888.    
  889.                    Number of copies           Price per copy
  890.                    ----------------           --------------
  891.                              1                   $39.00
  892.                        2 -   9                    28.00
  893.                       10 -  24                    24.00
  894.                       25 -  49                    21.00
  895.                       50 - 100                    19.00
  896.    
  897.    All payments must be in U.S. dollars.
  898.    
  899.    Regardless of the quantity ordered, only one (1) manual, and one disk
  900.    containing the registered copy of the Toolkit will be mailed. Upon
  901.    receipt, you will be authorized to make as many copies of the Toolkit as
  902.    you are licensed. The printed manual may not be reproduced. Additional
  903.    printed manuals are $6.00 each.
  904.    
  905.    
  906.                                  Refund Policy
  907.                                  -------------
  908.    
  909.    Each registration comes with a 30 day, no questions asked, money back
  910.    guarantee. In the event of a system incompatibility, the guarantee is
  911.    extended to a full 90 days.
  912.    
  913.    Upon receipt of properly returned merchandise, Contrails will refund the
  914.    full purchase price of the software less shipping and handling. Contrails
  915.    will not accept items returned with insufficient postage or COD charges.
  916.    
  917.    Before you return the Toolkit you must contact Contrails, Inc. for a
  918.    Return Authorization number. Returns will not be accepted without one.
  919.    
  920.    You must return the registered disk, and manuals in good condition.
  921.    
  922.    
  923.                                  ASP Ombudsman
  924.                                  -------------
  925.    
  926.    This program is produced by a member of the Association of Shareware
  927.    Professionals (ASP). ASP wants to make sure that the shareware principle
  928.    works for you. If you are unable to resolve a shareware-related problem
  929.    with an ASP member by contacting the member directly, ASP may be able to
  930.    help. The ASP Ombudsman can help you resolve a dispute or problem with an
  931.    ASP member, but does not provide technical support for members' products.
  932.    Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-
  933.    9427 or send a Compuserve message via CompuServe Mail to ASP Ombudsman
  934.    70007,3536"
  935.    
  936.    
  937.    
  938.    
  939.    
  940.    
  941.    
  942.    
  943.    
  944.    
  945.                                       -15-